ValidatedStringMap

open class ValidatedStringMap<V>(defaultValue: Map<String, V>, keyHandler: Entry<String, *>, valueHandler: Entry<V, *>) : ValidatedField<Map<String, V>> , Map<String, V>

A Validated Map with String keys

Author

fzzyhmstrs

Since

0.1.0

Parameters

V

any non-null type with a valid Entry for handling

defaultValue

the default map

keyHandler
valueHandler

the value handler, an Entry

See also

using the builder is recommended

Samples

import me.fzzyhmstrs.fzzy_config.util.EnumTranslatable
import me.fzzyhmstrs.fzzy_config.validation.Shorthand.validated
import me.fzzyhmstrs.fzzy_config.validation.collection.*
import me.fzzyhmstrs.fzzy_config.validation.minecraft.ValidatedIdentifier
import me.fzzyhmstrs.fzzy_config.validation.misc.ValidatedBoolean
import me.fzzyhmstrs.fzzy_config.validation.misc.ValidatedString
import me.fzzyhmstrs.fzzy_config.validation.number.ValidatedInt
import net.minecraft.registry.RegistryKeys
import net.minecraft.util.Identifier

fun main() { 
   //sampleStart 
   //Example ValidatedStringMap with basic validation
val validatedStringMap = ValidatedStringMap(mapOf("a" to 1), ValidatedString(), ValidatedInt())

//fields and sections have lang keys based on their "location" in the Config class graph.
//Lange key composition is as follows
//1. the namespace of the config id: (my_mod)
//2. the path of the config id: (my_mod.my_config)
//3. any parent ConfigSection field names as declared in-code: (my_mod.my_config.subSection)
//4. the setting field name as declared in-code: (my_mod.my_config.subSection.fieldName)
val fieldLang = """
{
    "_comment1": "the lang for an example 'fieldName' setting in a config inside section 'subSection'",
    "my_mod.my_config.subSection.fieldName": "Very Important Setting",
    "my_mod.my_config.subSection.fieldName.desc": "This very important setting is used in this very important way."
}
""" 
   //sampleEnd
}

Constructors

Link copied to clipboard
constructor(defaultValue: Map<String, V>, keyHandler: Entry<String, *>, valueHandler: Entry<V, *>)

Types

Link copied to clipboard
class Builder<V : Any>

Builds a ValidatedMap

Link copied to clipboard
object Companion

Properties

Link copied to clipboard
open override val entries: Set<Map.Entry<String, V>>
Link copied to clipboard
open override val keys: Set<String>
Link copied to clipboard
open override val size: Int
Link copied to clipboard
open override val values: Collection<V>

Functions

Link copied to clipboard
open override fun accept(input: Map<String, V>)

updates the wrapped value. NOTE: this method will push updates to an UpdateManager, if any. For in-game updating consider validateAndSet

Link copied to clipboard
open fun addListener(listener: Consumer<ValidatedField<Map<String, V>>>)

Attaches a listener to this field. This listener will be called any time the field is written to ("set"). accept, validateAndSet, setAndUpdate and so on will all call the listener.

Link copied to clipboard
open fun andThen(p0: Consumer<in Map<String, V>>): Consumer<Map<String, V>>
Link copied to clipboard
fun codec(): Codec<Map<String, V>>

Provides a Codec representing the value type of this validation, backed by the validators within as applicable

Link copied to clipboard
open override fun containsKey(key: String): Boolean
Link copied to clipboard
open override fun containsValue(value: V): Boolean
Link copied to clipboard
open override fun copyStoredValue(): Map<String, V>

Copies the stored value and returns it.

Link copied to clipboard
open fun description(fallback: String? = null): MutableText

The translated Text description from the descriptionKey. Falls back to an empty string so no tooltip is rendered.

Link copied to clipboard
open override fun descriptionKey(): String

translation key of this Translatable's description. the "description" in-game, the descriptions Enchantment Descriptions adds to enchantment tooltips are a good example.

Link copied to clipboard
open fun flags(): Byte
Link copied to clipboard
open fun forEach(p0: BiConsumer<in String, in V>)
Link copied to clipboard
open override fun get(): Map<String, V>

supplies the wrapped value

open operator override fun get(key: String): V?
Link copied to clipboard

Provides this validations default value

Link copied to clipboard
open fun getOrDefault(key: String, defaultValue: V): V
Link copied to clipboard

Whether this Translatable has a valid description

Link copied to clipboard
open override fun hasFlag(flag: EntryFlag.Flag): Boolean
Link copied to clipboard

Whether this Translatable has a valid translation

Link copied to clipboard
open override fun instanceEntry(): ValidatedStringMap<V>
Link copied to clipboard
open override fun isEmpty(): Boolean
Link copied to clipboard
fun <N> map(to: Function<Map<String, V>, out N>, from: Function<in N, Map<String, V>>): ValidatedField<N>

Maps this validation to a new convertible type. The default value will be applied from this delegates current storedValue

fun <N> map(defaultValue: N, to: Function<Map<String, V>, out N>, from: Function<in N, Map<String, V>>): ValidatedField<N>
fun <N> map(to: Function<Map<String, V>, out N>, from: Function<in N, Map<String, V>>, defaultValue: Map<String, V>): ValidatedField<N>

Maps this validation to a new convertible type.

Link copied to clipboard

Convert this field to a ValidatedCondition using the provided validation as a supplier. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied.

open fun toCondition(condition: Supplier<Boolean>, failMessage: Text, fallback: Supplier<Map<String, V>>): ValidatedCondition<Map<String, V>>

Convert this field to a ValidatedCondition. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied.

open fun toCondition(scope: String, failMessage: Text, fallback: Supplier<Map<String, V>>): ValidatedCondition<Map<String, V>>

Convert this field to a ValidatedCondition using the provided scope with a default boolean provider. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied. The provided scope must point to a valid boolean config scope otherwise the initial condition will never pass.

Link copied to clipboard
fun toList(vararg elements: Map<String, V>): ValidatedList<Map<String, V>>

wraps the provided values into a ValidatedList with this field as validation

wraps the provided collection into a ValidatedList with this field as validation

Link copied to clipboard
fun toSet(vararg elements: Map<String, V>): ValidatedSet<Map<String, V>>

wraps the provided values into a ValidatedSet with this field as validation

fun toSet(collection: Collection<Map<String, V>>): ValidatedSet<Map<String, V>>

wraps the provided collection into a ValidatedSet with this field as validation

Link copied to clipboard
open override fun translation(fallback: String?): MutableText

The translated Text name from the translationKey. Falls back to the implementing classes Simple Name (non-translated)

Link copied to clipboard
open override fun translationKey(): String

translation key of this Translatable. the "name" in-game

Link copied to clipboard
fun trySerialize(input: Any?, errorBuilder: MutableList<String>, flags: Byte): TomlElement?
Link copied to clipboard
open override fun trySet(input: Any?)
Link copied to clipboard
open fun update(updateMessage: Text)
Link copied to clipboard

A setter method for the storedValue that first validates the value being set and then stores the post-validation result.

Link copied to clipboard

A setter method for the storedValue that first validates the value being set and then stores the post-validation result.

Link copied to clipboard
open fun widgetAndTooltipEntry(choicePredicate: ChoiceValidator<Map<String, V>> = ChoiceValidator.any()): ClickableWidget